home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Compression / UUParser 1.72 ƒ / UUParser 1.72 / UUParser 1.72.rsrc / TEXT_300.txt < prev    next >
Text File  |  1994-05-12  |  20KB  |  544 lines
  1.     
  2.  
  3.  
  4.  
  5.  
  6.             UUParser
  7.     an Internet file extraction utility for the Macintosh‚Ñ¢
  8.  
  9.  
  10. By John S. Lee, ¬© 1993,1994.
  11.  
  12. UUParser takes out the header information in files that have been
  13. uuencoded and uploaded to a newsgroup.
  14.  
  15. UUParser also allows you to "S"ave multiple articles from newsgroups,
  16. normally in several parts, and re-assembles them as one contiguous file
  17. ready for uudecoding.
  18.  
  19. UUParser can also automatically uudecode files for you.
  20.  
  21.  
  22.  
  23. Directory    
  24.  
  25. FEATURES - The funtions of UUParser. 
  26. INSTRUCTIONS - Getting UUParser set up for the first session.
  27. FILE MANIPULATION (FILE MENU) - How to UUParse.
  28. PREFERENCES - Configuring UUParser.
  29. EDIT FILE TYPES - Making UUParser "SMART".
  30. SPECIAL - Special options in UUParser.
  31. REGISTRATION - How to get rid of the nasty reminder message.
  32. CREDIT - To each his/her proper due!
  33. COLD MOD STUFF - What's been changed/fixed/modified.
  34. UUParser Internals & Notes - Do's, how's, why's, where's, dont's!
  35. Upgrades - Upgrade information for registered users.
  36. Future Additions - Functions to make UUParser even better.
  37. Hints - Methods you can use to get the most out of UUParser.
  38.  
  39.  
  40.    
  41.  
  42. Features    
  43.  
  44. ‚Ä¢ Automatic stripping of header information from files "S"aved
  45.    from a usenet newsgroup.
  46. ‚Ä¢ "Smart" uudecoding.  Fully user configurable.
  47. ‚Ä¢ uuencoding of AIFF (sound) files is now supported.
  48. ‚Ä¢ uuencoding in PC, UNIX, and AIFF formats.
  49. ‚Ä¢ User control over output file location.
  50. ‚Ä¢ Join multiple text files for UUParsing & automatic decoding, from
  51.    the menu OR the desktop.
  52. ‚Ä¢ Split any text file into multiple parts using the Split File function.
  53. ‚Ä¢ User configurable preferences.
  54. ‚Ä¢ Automatic scan of text files for anomalies.
  55. ‚Ä¢ Drag & Drop UUParsing supported via System 7.
  56. ‚Ä¢ Parsing/uudecoding/encoding occurs in the background.
  57. ‚Ä¢ Decodes/encodes/parses ANY SIZE FILE, regardless of memory.
  58. ‚Ä¢ Parses BinHex files (version 1.8).
  59. ‚Ä¢ The FASTEST uudecoding/encoding available for the Mac!
  60.  
  61.  
  62. Instructions    
  63.  
  64. Double-click on the application "UUParser"
  65.  
  66. (Note: If this is the first time you have used UUParser or 
  67.  are upgrading from a previous version you MUST set the 
  68. Target Directory!)
  69.  
  70. Select Set Target Directory from the Special menu so that
  71. UUParser knows where to put the output files.  This directory
  72. will also be used as the defualt for placement of decoded files.
  73. (see note above)
  74.  
  75. Select Auto UUDecode from the SPECIAL menu if you want to 
  76. automatically uudecode the parsed files.
  77.  
  78. Select UUParse or UUParse Several from the FILE menu.
  79.  
  80. Select the file you want to parse.
  81.  
  82. Choose another file or CANCEL (cmd .).
  83.  
  84. If you did not choose to Auto UUdecode your file you can 
  85. uudecode it using UUDecode from the FILE menu.
  86.  
  87. DRAG & DROP
  88. Select the documents you want to parse and drag them to the 
  89. UUParser  icon.  
  90. The application will start and the files will be parsed, decoded
  91. and placed in you target directory.
  92.  
  93. *Holding down the Command key will automatically join the files!
  94. *Selecting "Drag&Drp then Quit" in the Preferences will tell
  95. UUParser to Quit after the drag & drop operation is complete.
  96.  
  97.  
  98. File Manipulation    
  99.  
  100.  
  101. UUParse/UUParse Several
  102. Opens files(s) for parsing.
  103.  
  104. Parse BinHex File
  105. Parses a file that contains BinHex data.   This function is
  106. enabled when your copy of UUParser is registered.
  107.  
  108. Join Files
  109. Takes any number of files parses them and concatentates them.
  110. Choose the first file to join.  Subsequent selections are attached
  111. to the first file.  Parse the file and it's ready to uudecode.
  112.  
  113. Split File
  114. Takes a file and seperates it into sections of 200-2000 lines each.
  115. Each can then be uploaded to a newsgroup in succession for
  116. someone to retrieve and re-assemble. This feature AUTOMATICALLY
  117. installs BEGIN/END cut lines in each of the files it generates.
  118.  
  119. uudecode (smart)
  120. uudecodes file(s) that has been parsed.  Before decoding it 
  121. determines, by parameters you set (see Set File Types), 
  122. what type of file type it should have.  Once decoded it
  123. appears on the desktop as a document of the application 
  124. you specify.
  125.  
  126. uuencode (configurable)
  127. uuencodes a file. UUParser can encode items in PC/MS-DOS,
  128. UNIX, AIFF->Linear (for sound), and AIFF->ULAW (for sound).
  129. UUParser will also give create a filename in the proper format
  130. for the encoding scheme chosen (i.e. if you chose MS-DOS the filename
  131. will be 8chars.ext.; UNIX will have all whitespace replaced by "_").
  132. The default scheme is UNIX, but you can change it from the MENU 
  133. Encode Options, or in the Preferences dialog box.   If Mac is chosen
  134. the scheme will use the UNIX encoding, but use the Macintosh
  135. conventions for the filename.
  136.  
  137.  
  138. Edit File Types    
  139.  
  140.  
  141. This function allows you to select a string that UUParser will
  142. use to set the file's type and creator (so that they are recognized
  143. by the Finder and your favorite application(s).  You select it
  144. from the Edit menu.  You enter the file suffix along with the 
  145. file type and creator associated with the file.  You are allowed
  146. 10 entries.  Many of them are already set up for you.
  147. (example  file.jpg:             file suffix: .jpg
  148.                                        file type       : JIFF
  149.                                        file creator  : JVWR
  150.  
  151.    This sample shows that any file that is decoded that has the 
  152.   ".jpg" extension in the filename will be set to the JPEGViewer
  153.    file type.  This allows JPEGView to open the file directly from the
  154.    finder without first "fixing" the file.)
  155.  
  156. The file suffix can be in upper/lower/mixed case.  UUParser will
  157. correctly set the type/creator!
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165. Preferences    
  166.  
  167. Default values are enclosed in "[]".
  168.  
  169. Memory:
  170. Disk based parsing  [ON]
  171.  Read a file using the availble memory.  Use this option if
  172.  you are trying to parse a file that is larger than the available
  173.  memory (i.e a 900k file, and UUParser has a 640k partition).
  174.  
  175. File Control:
  176. Delete source file  [OFF]
  177.  Delete the soruce file once the scanning/parsing process
  178.  has been done.
  179.  
  180. Delete .uu file [OFF]
  181.  Delete the intermediate (filename.uu)
  182.  file once the scanning/parsing process 4& done.
  183.  At times, you may want to keep this file for
  184.  debugging purposes.
  185.  
  186. Show status  [ON]
  187.  Show progess indicator, just to let you know how much of the 
  188.  file has been scanned/parsed.
  189.  
  190. SCAN file [ON]
  191.  Check each character in the file to amke sure it is an ascii "printable" 
  192.  character.  Prevents bad data (from a bad transmission or poor
  193.  line conditions) from being interpreted by the uudecoding function.
  194.  
  195. Encoding:
  196. PC - Uses pc-encoding.  Use this option when dealing with those,
  197. er, MS-DOS machines.  Common encoding method used in usenet
  198. newsgroups.
  199.  
  200. UNIX [ON]- Uses standard uuencode technology.  This one accepted
  201. standard on Usenet Newsgroups.  This is the default setting.
  202.  
  203. MAC - Uses the UNIX standard of encoding BUT uses the Macintosh
  204. filenaming convention (anything goes except ":").  This
  205. version of UUParser is not intended to be used for encoding of 
  206. applications, just documents and data files.  Therefore there is no
  207. guarantee that if you encode an app that you will be able to get
  208. it back (since UUParser ONLY encodes the data portion of files!).
  209.  
  210. AIFF->ULAW - Convert AIFF file to ULAW format (useful when
  211. transferring sounds to Sun or NeXT workstations.
  212.  
  213. AIFF->Linear - Convert AIFF file to Macintosh Linear format.
  214.  
  215. File Splitting:
  216. Set the UNIX read/write permissions (100-888) [644].
  217. Set the lines/segment for the file that you wish to split [900].
  218.  
  219. Display:
  220. Show line/byte info [YES].  
  221. Used for debugging purposes.
  222. Indicates the actual number of lines and bytes read from
  223. the selected file.
  224.  
  225. Alerts:
  226. Show Minor Problems [NO].
  227. Displays errors concerning line length. Also warns of non-
  228. contiguous files (i.e. 'begin' found before and 'end').
  229. Usually does not affect parsing/decoding.
  230.  
  231. Misc:
  232. Auto-SAVE [YES].
  233. Will automatically save parsed files and decode them immediately
  234. after parsing has completed successfully.  They are written to
  235. the target directory specified by the user.  Set this option to
  236. ON and set the Auto UUDecode to ON if you would like to
  237. join, parse, and decode.
  238.  
  239. Drag&Drop then Quit [NO]
  240. Tells UUParser to quit after parsing/decoding/etc. has been 
  241. performed on files that have been Dragged & Dropped onto
  242. the UUParser icon.
  243.  
  244. The OK button makes the changes for the session only.  No changes
  245. are saved to the prefs file. 
  246.  
  247. The SAVE button writes the changes to the prefs file.
  248.  
  249. The Cancel button discard all changes.
  250.  
  251. The Default Settings button sets the preferences to the default
  252. values outlines above.
  253.  
  254.  
  255. Special    
  256.  
  257. Scan Only
  258. The SCAN ONLY disables all parsing/decoding functionality and
  259. scans the files for non-printable characters.  If it finds 
  260. these characters it issues a warning with what it found.
  261.  
  262. Auto UUDecode
  263. This function allows automatic uudecoding of files that have been 
  264. parsed.  By default this option is ON.
  265.  
  266. While this function is enabled UUParsing & uudecoding occur
  267. in one pass.  The files are placed in your Target Directory
  268. (see below).
  269.  
  270. Set Target Directory
  271. NOTE:When using UUParser for the first time you MUST
  272. set the target directory.  This is where all your
  273. UUParsed files will go!  If it is not set, UUParser
  274. will put the files in it's home directory OR the desktop!
  275.  
  276. Set target directory lets UUParser know where to put your file
  277. once it has been parsed.  This is also handy because that directory
  278. will be the first one looked into when the Auto UUDecode option
  279. has been chosen.  Making the process of parsing/decoding
  280. truly one step and painless.
  281.  
  282.  
  283. Cold Mod Stuff    
  284.  
  285.  
  286. An abbreviated, but accurate history:
  287.  
  288. (Version 0.9)    Initial Coding
  289.  
  290. (Version 0.9b)  Added multiple-file parsing
  291.                         additional conditions for parsing
  292.  
  293. (Version 1.0)   Added faster parsing.  Better memory management
  294.                        parsing in memory.
  295.  
  296. (Version 1.1)   Added uudecoding w/ automatic 
  297.                        file type/creator setting.
  298.  
  299. (Version 1.1f)  Better error detection of files that have no "end" markers.
  300.                        Added Join Files capability.
  301.  
  302. (Version 1.2)   Added multiple-file drag-drop parsing functionality.
  303.                        Data errors are not reported on a byte/byte basis, 
  304.                        just once.
  305.                        Parsing process is speeded up ten-fold.  
  306.                        Operates on a 100k file in 1.5
  307.                        secs (as tested on a IIsi w/o math).
  308.                        uudecode speeded up. 
  309.                        Create versions of UUParser for each type of platform:
  310.                       1.2  -> for all macs 68000 and up
  311.                       1.2(020) -> for macs w 68020/68030/68040 w/o math co.
  312.                       1.2(020/881) -> all macs w/ 020/030/040 & math co.
  313.  
  314. (Version 1.3)  Added uuengine technology.  Background processing
  315.                       when uudecoding.  UUdecode/encode window is now movable.
  316.                       Have the option of continuing when disk errors occurs.
  317.                       (previously it exited the program!).
  318.                       Can now select target directory for uudecoded files.
  319.  
  320. (Version 1.5)  Added configurable uuencoding, smart uudecoding,
  321.                       selection of automatic type/creator, splitting of files,
  322.                       selection of encoding scheme from menu, setting of
  323.                       target directory for UUParsed files, multiple file selection
  324.                       when decoding.  Auto-Decode automatically set to "ON". 
  325.                       Universal code now compatible with ALL Macintoshes
  326.                       (running sys 7).
  327.  
  328. (Version 1.7)  Better memory management.  UUParser can parse large
  329.                       files regardless of the amount of memory available to
  330.                       the application.  UUParser can parse in the background.
  331.                       UUParser now notifies you when parsing has completed
  332.                       (when running in the background).  You can have UUParser
  333.                       rename the files in upper case.  During Drag & Drop,
  334.                       if you hold down the COMMAND key, UUParser will 
  335.                       automatically Join the files for you. 
  336.  
  337. (Version 1.71) Allows parsing of files irregardless of amount of memory.
  338.                        Decreased the allocated memory size to 384k.
  339.  
  340. (Version 1.71c) Allows parsing of files irregardless of amount of 
  341.                          memory.
  342.                        Fixed file locking problems,and  problems with 
  343.                        joining from the finder.
  344.  
  345. (Version 1.72) First registered users version.  Removed memory 
  346.                        restrictions for joining.  
  347.                        Fixed file locking problem during abort.
  348.  
  349. (Version 1.72a)Disk based version.  Requires no additional memory ‚Ć                   join files.
  350.                        Fixed file locking problems,and  problems with 
  351.                        joining from the finder.  Integrated changes into
  352.                        version 1.72 (1.72 is now shareware as of 5/94).
  353.  
  354. (Version 1.8)  Added binhex file parsing.
  355.  
  356. * 1.72 is the shareware version until further notice.
  357.  
  358. UUParser Internals & Notes    
  359.  
  360.  
  361. UUParser stores the preferences info in the UUP Prefs file
  362. in the Preferences folder in your System Folder.  The Prefs
  363. consists of UUParser parsing options, encoding prefs, 
  364. and target directory info.  The file suffix parms that make UUParser
  365. "smart" are stored in the AtTr & STR# resources.  Because
  366. UUParser makes certain assumtions about these files you should
  367. not change them directly!  If you do UUParser will not work properly
  368. or at all.  If you have to make changes, use UUParser's Preferences
  369. from the File menu to do so!
  370.  
  371. If you have a previous version of UUParser (0.9-1.2) you may get a
  372. disk error when the program is started.  This is becuase the Prefs file
  373. format is different in 1.7 than in previous versions.  Dont worry. 
  374. Just hit the continue button, set up your preferences, choose
  375. a target directory and the problem will be corrected (be sure to
  376. SAVE your prefs).
  377.  
  378. I wanted to make UUParser useful for systems 6 & 7.  Since
  379. system 7 has so many niceities when it comes to file handling
  380. I decided that version 1.7 and up would be reliant on system 7 for
  381. proper usage.  Some items may not work properly if you are not
  382. using system 7.
  383.  
  384. The "use 20 times and pay" policy was my idea of fair.  
  385. Most shareware programs have a 30 days policy, 
  386. but I figured that after a certain amount of uses you would get a
  387. good idea as to UUParsers worth.  20 was the number I came up with.
  388. Why did I mention this?  To once again encourage you to use it, and pay
  389. for it once you have used it 20 times.  There will be upgrades and
  390. additions that you will get ONLY if you are registered.  When you
  391. register, the NOT REGISTERED message is removed.
  392.  
  393.  
  394.  
  395. Upgrades    
  396.  
  397. To keep things simple, cheap, and virtual, I will e-mail all upgrades
  398. to UUParser's registered owners.
  399.  
  400. To upgrade  thru the mail (available to registered uses ONLY):
  401. $15 w/ SASE
  402. $10 w/ SASE + DISK
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415. Future Additions    
  416.  
  417.  
  418. UUParser was originally designed to do one thing, parse files.
  419. Now it has many features and additions that extends that basic
  420. funtion.  It is now a full fledged uudecoder/uuencoder, file
  421. splitter, and text file verifier.  But the fans, and registered
  422. users of UUParser have asked for even more, and I am more than
  423. happy to include these additions for UUParser users.   The next major
  424. release will be 2.0.  There may  be intermediate versions until 2.0, but
  425. these will concentrate on mods to version 1.5 technology.  
  426. Version 2.0 will be avaialble to registered users only.
  427.  
  428. Version 2.0 will include:
  429. ‚Ä¢Control over parsing parameters.
  430. ‚Ä¢A more versatile join function.
  431. ‚Ä¢Encode/decode Mac apps.
  432. ‚Ä¢Binhex encode/decode.
  433. ...and LOTS more! 
  434.  
  435.  
  436.  
  437. Hints    
  438.  
  439.  
  440. ‚Ä¢ To save time if you have multiple files "Join" them into one file,
  441. then parse the joined file.  If Auto-UUDecode is on ALL of the files
  442. will be decoded and placed in your Target Directory. Make sure
  443. you allocate enough memory for this operation.  If you use set
  444. Auto-SAVE in your preferences, the joined file will automatically
  445. be parsed and decoded (if you checked the "Auto UUDecode" from
  446. the Special menu).
  447.  
  448. ‚Ä¢ If you get -1 disk errors while decoding it means that the 
  449. file is corrupt.  Some people have trouble sending files to 
  450. newsgroups.  You can attempt to fix the file with a text editor
  451. or try another file.
  452.  
  453. ‚Ä¢ Disk errors that occur when the program is loading are most
  454. likely due to an error UUP Prefs file.  You should be able to continue.
  455. Reset your preferences, set your target directory, and save the
  456. changes.  This will correct the file.  If it does not work, delete the
  457. prefs file and re-start UUParser (the file is in "System Folder:
  458. Preferences:UUP Prefs").
  459.  
  460. ‚Ä¢ If you get disk errors while UUParsing or uudecoding they are
  461. most likely due to the target directory not being set.  Remember
  462. to set up your Target Directory when you use UUParser for the
  463. first time.  The changes are saved to the preferences file.
  464.  
  465. ‚Ä¢ Some people do not put cut lines in their files.  Instead they
  466. use line breaks, or worse yet, blank lines.  There really is no
  467. universal rule about posting to a newgroup.  If you have problems
  468. with a file check it out with a text editor, delete the offending lines,
  469. UUParse the file again,and re-attempt decoding.  If this does not
  470. work the file is probably bad.
  471.  
  472. ‚Ä¢ Remember when Joining, the files must be in the right
  473. order if you are planning to parse/decode them.  Take great
  474. care in the join process.
  475.  
  476. ‚Ä¢ I am always looking for ways to improve this product.  If you
  477. have any ideas as to what you'd like to see UUParser do,
  478. that it does currently not do, or just changes you'd like to see,
  479. don't be shy.  E-mail me with your suggestion.  I will get back to you
  480. asap.
  481.  
  482.  
  483.  
  484. Registration    
  485.  
  486. UUParser is SHAREWARE.  Use it 20 times.  If you like it, register it
  487. by sending $25.00 (US funds) to:
  488.  
  489. John S. Lee
  490. 1600 Fell St. #210
  491. San Francisco, CA. 94117
  492.  
  493. e-mail (for bug reports, enhancement requests, and questions):
  494. Internet->   jsl@netcom.com
  495. AOL       ->   JSLee
  496.  
  497. By registering you are entitled to updates of UUParser
  498. as they become available.
  499.  
  500. This HELP document does not replace the documentation.  
  501. Read it for additional technical 
  502.  information about UUParser.
  503.  
  504. THANKS for using UUParser!
  505.  
  506.  
  507. Credits    
  508.  
  509.  
  510. Programming/Design: John S. Lee
  511.  
  512. Testing                     : Mike Baranowski & Brian K. Tanaka
  513. Support                    : Arlene G. Lee & Sultan I. Lee
  514. uu-engine software   : B. Wieser & Octavian Micro Development
  515. Documentation          : Mike Baranowski & John S. Lee
  516. uudecode info            : Peter Honeyman, Robert Perlberg, and Tim Rose
  517. Help Dialog Utility     : James W. Walker
  518. Special Props           : Brian K. Tanaka for the ever consistent
  519.                                  "You know, it would be even better if..." &
  520.                                  "You know what you oughta add is..."
  521.  
  522.                                  Mike Baranowski for the ever present
  523.                                  "Is there a way of..." & "...can you add this
  524.                                    one other mod...".
  525.  
  526.                                  B. Wieser for user interface suggestions. 
  527.  
  528.                                  To ALL of them for the many ideas that makes
  529.                                  UUParser useful and fun to use.
  530.  
  531.  
  532. uu-engine Copyright 1991 by B. Wieser and Octavian Micro Development.
  533. Macintosh‚Ñ¢ is a registered trademark of Apple Computer, Inc.
  534. UNIX‚Ñ¢ is a registered trademark of AT&T Information Systems.
  535.  
  536. Legal note:  Use the software at your own risk.  I am not responsible for
  537. lost data.  The program has been tested as best it could be.  I make no other
  538. warranties, either expressed or implied.
  539.  
  540. UUParser is Copyright 1993,1994 by John S. Lee & Truly Mac, Inc.
  541. All Rights Reserved.
  542.  
  543.     
  544.